package com.studyweb.service;

import com.studyweb.pojo.entity.Vocabulary;

import java.util.List;
import java.util.Map;

/**
 * 词语积累服务接口
 */
public interface VocabularyService {
    
    /**
     * 添加词语
     * 
     * @param vocabulary 词语实体
     * @return 添加结果
     */
    boolean addVocabulary(Vocabulary vocabulary);
    
    /**
     * 根据ID查询词语
     * 
     * @param id 词语ID
     * @return 词语实体
     */
    Vocabulary getVocabularyById(Long id);
    
    /**
     * 更新词语信息
     * 
     * @param vocabulary 词语实体
     * @return 更新结果
     */
    boolean updateVocabulary(Vocabulary vocabulary);
    
    /**
     * 删除词语
     * 
     * @param id 词语ID
     * @return 删除结果
     */
    boolean deleteVocabulary(Long id);

    /**
     * 批量删除词语
     * 
     * @param ids 词语ID列表
     * @return 删除结果
     */
    boolean batchDeleteVocabulary(List<Long> ids);
    
    /**
     * 分页查询词语列表
     * 
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @param keyword 关键词
     * @return 词语列表和总数
     */
    Map<String, Object> getVocabularyList(int pageNum, int pageSize, String keyword);
    
    /**
     * 获取练习词语
     * 
     * @param count 数量
     * @return 词语列表
     */
    List<Vocabulary> getPracticeVocabularies(int count);
    
    /**
     * 获取所有词语列表
     * 
     * @return 词语列表
     */
    List<Vocabulary> getAllVocabularies();
    
    /**
     * 更新词语掌握程度
     * 
     * @param id 词语ID
     * @param masteryLevel 掌握程度
     * @param reviewCount 复习次数
     * @return 更新结果
     */
    boolean updateMasteryLevel(Long id, Integer masteryLevel, Integer reviewCount);
}